home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / sharew / dfue / cat / catsieve / catsieve.man < prev    next >
Text File  |  1992-11-13  |  26KB  |  577 lines
  1. CATSIEVE - Laberfilter für den Maustausch
  2.  
  3.     Die aktuelle Version des Programmes ist 0.99 vom 13. November 1992.
  4.  
  5.  
  6.  
  7.  
  8. Autor:
  9.     Uwe Ohse
  10.     Fürstenallee 3
  11.     Zimmer 2.0.4
  12.     4790 Paderborn
  13.     Mailbox: Mausnetz (wo sonst?): Uwe Ohse @ PB,
  14.  
  15. Hinweis zum Copyright:
  16.  
  17.  
  18.                     Copyright (c) 1991,1992  Uwe Ohse
  19.                     Alle Rechte vorbehalten
  20.  
  21.  
  22.    Catsieve ist Postcardware. Das bedeutet:
  23.  
  24.      Wer Catsieve benutzt, sollte mir eine Postkarte aus seinem Heimatort
  25.      schicken.
  26.  
  27.  
  28.     Das Programm darf in der oben angegebenen Version frei kopiert und in
  29.     Mailboxen des Mausnetzes oder anderer Netze mit Maustauschpointformat
  30.     abgelegt werden.
  31.     Eine Verbreitung über andere Medien ist nicht gestattet.
  32.  
  33.     Das Programmpaket darf nur vollständig weitergegeben werden, d.h. die
  34.     folgenden Dateien:
  35.  
  36.        catsieve.prg  -  Ausführbares Programm
  37.        catsieve.rsc  -  Gem Resource Datei
  38.        catsieve.man  -  Anleitung
  39.        catsieve.inf  -  Konfigurationsdatei
  40.        catsieve.rul  -  Beispielregeln
  41.        manifest      -  Diese Datei
  42.        changes.txt   -  eine Aufzählung der letzten Änderungen
  43.     müssen immer zusammen kopiert werden.
  44.  
  45.  
  46.  
  47. 1. Kurzbeschreibung
  48.  
  49.    Catsieve ist ein sogenannter Laberfilter. Er kann aber auch noch etwas
  50.    mehr. :-) z.B. Mails automatisch in Dateien kopieren.
  51.    Das Programm ist voll gemgesteuert. Es wird nach Empfang des Outfiles
  52.    und noch vor Start des Maustauschprogrammes aufgerufen.
  53.  
  54.  
  55.    (Achtung, Eigenwerbung!)
  56.    Catsieve benutzt fliegende Dialoge, genauer gesagt: die FLYS-Library.
  57.    Diese Library ist als Shareware bei mir, ihrem Autor, erhältlich, und bietet
  58.    Circlebuttons, Popups, runde Radiobuttons, Checkbuttons, Tastaturshortcuts,
  59.    erweiterte Editierfunktionen, Rahmen und erweiterte Stringtypen. Natürlich
  60.    können die Dialoge auch unsichtbar gemacht und verschoben werden.
  61.  
  62.    Der Sharewarebeitrag für die Library beträgt 25 DM, die jeweils aktuellste
  63.    Version kann aus der QUARK Paderborn (im Brett ST-Tools oder ST-Librarys)
  64.    gesaugt werden.
  65.  
  66. 2. Systemvoraussetzung
  67.  
  68.    Für den bequemen Betrieb ist ein Atari Computer mit mindestens einem
  69.    Megabyte RAM und Harddisk Voraussetzung.
  70.    Catsieve kann wahrscheinlich (was bedeutet: Ich habe es nicht ausprobiert)
  71.    auch mit 512 KB Speicher benutzt werden, aber dann könnte es zu Problemen
  72.    beim Aufruf der Packer kommen. Insbesondere neuere Lharc's (2.01x)
  73.    benötigen zum Einpacken extrem viel Speicher.
  74.    Ein Betrieb ohne Harddisk ist für mich nur schwer vorstellbar (MausTausch
  75.    ohne HD ?), dürfte aber bei Verwendung zweier Diskettenlaufwerke möglich
  76.    sein. In diesem Fall sollte man aber insbesondere auf das Anlegen vom
  77.    Backup's (Menü Optionen, Punkt Sicherungspfade) verzichten! Trotzdem kann,
  78.    da Catsieve ausgesprochen auf Sicherheit programmiert ist und auf jeden
  79.    Fall eine Arbeitskopie des OUTFILEs (Eingangsoutfile) macht,
  80.    Speicherplatzmangel auftreten. In diesem Fall bricht das Programm das
  81.    Filtern ab.
  82.  
  83.  
  84. 3.Installation
  85.  
  86.    Kopieren sie Catsieve mit der dazu gehörigen RSC-Datei und der
  87.    Beispielregeldatei CATSIEVE.RUL und der Infodatei CATSIEVE.INF
  88.    in einen Ordner ihrer Wahl.
  89.  
  90.    Frage: "Regeldatei? Was denn für ein Regeln?"
  91.    Antwort: "eben Regeln, was Catsieve tun soll!"
  92.  
  93. 4. Regeln
  94.    An dieser Stell zuerst einmal eine Erklärung, was eine Catsieveregel
  95.    überhaupt ist. Sie besteht aus einem Namen (der für das Filtern
  96.    vollkommen bedeutungslos ist), bis zu fünf Suchworten (nach denen der
  97.    Filter sucht. Sie werden ver-odert, es reicht also, wenn ein Suchwort
  98.    gefunden wird!) sowie diversen Flags, die angeben
  99.    - wo gesucht werden soll (Gruppenname, Betreff, Absender, Empfänger
  100.      [bei Mails aus dem Mausnetz nicht vorhanden], ID, Text).
  101.    - wie die Suchworte verglichen werden sollen.
  102.      'Exakt'      bedeutet, daß die entsprechende Angabe in der Mail
  103.                   vollständig mit dem Suchwort übereinstimmen soll.
  104.      'Wortgenau': Das Suchwort darf nicht Teil eines Wortes sein. Die
  105.                   Zeichen mit denen Catsieve unterscheidet, ob ein Wort
  106.                   beginnt/endet, kann man im Menü 'Optionen' global (d.h. für
  107.                   alle Regeln) einstellen.
  108.      'ungenau':   Das Suchwort muß einfach nur in der entsprechenden
  109.                   Angabe der Mail vorkommen.
  110.   - Für welche Gruppen die Regel gilt.
  111.     'Keine': Die Regel ist vollkommen abgeschaltet.
  112.     'Einige': Es wird nur in bestimmten Gruppen gesucht.
  113.     'Alle': Es wird in allen Gruppen gesucht.
  114.   - ob auch in persönlichen Mails gesucht werden soll ('Auch PM').
  115.  
  116.   - ob und wie die betreffenden Mails gelöscht werden sollen
  117.     'ignorieren': die Mail wird durch diese Regel nicht gelöscht.
  118.     'Niemals'   : alle von dieser Regel betroffenen Mails werden nicht
  119.                   gelöscht, auch wenn dies aufgrund anderer Regeln sonst
  120.                   passieren würde. Also eine Art 'Löschschutz'.
  121.     'Text'      : Es wird nur der Text der Mail gelöscht. Unter anderem
  122.                   erhält man dadurch die Kommentarverkettung. (sog.
  123.                   Teillöschung)
  124.     'ganz'     :  Die Nachricht wird vollkommen gelöscht.
  125.  
  126.   - ob und wie die Mails kopiert werden sollen.
  127.     'im Outfileformat': Kopiert eine Mail im Outfileformat in eine Datei.
  128.                         ==> diese Datei kann mit 'Outfile einfügen' in Cat
  129.                         importiert werden, wenn mit einem Texteditor als letzte
  130.                         Zeile ein '#' eingefügt wird.
  131.     'als Text'        : dito, nur als Text.
  132.     'nicht'           : Aufgrund dieser Regel werden keine Mails kopiert.~
  133.  
  134.   btw: In dieser Anleitung ist auch häufiger von 'Regeldateien' die Rede. Dies
  135.   sind Dateien mit bis zu 50 Regeln darin.
  136.  
  137. 5. Die Dropdownmenüs
  138.  
  139. 5.1 Das Menü CATSIEVE
  140.  
  141. 5.1.1 über Catsieve ...
  142.       Hier finden Sie die übliche Copyrightmeldung.
  143.       Der Knopf 'Info' führt
  144.  
  145. 5.1.2 zu einem weiteren Dialog, in dem Sie über die fliegenden Dialoge
  146.       informiert werden.
  147.       Bei der Gelegenheit eine Kurzanleitung:
  148.       Fliegen: Mausklick (links) aufs Eselsohr und dann verschieben.
  149.       Unsichtbarmachen: Mausklick (rechts + links) aufs Eselsohr.
  150.       Tastaturshortcuts: ALT und die unterstrichene Taste drücken.
  151.       Editierfunktionen: SHIFT Rechtspfeil/Linkspfeil führt an das Anfang
  152.         bzw. das Ende der Zeile.
  153.       Radiobuttons: (Das sind die runden Knöpfe mit dem nachfolgenden Text)
  154.         Sind wie normal zu bedienen, nur sehen sie eben besser aus :-)
  155.       Crossbuttons: (Das Äquivalent der einfachen wählbaren Knöpfe) Sie
  156.         können angekreuzt werden.
  157.       Circlebuttons: (Die krummen Pfeile :-) Mausklick auf Pfeil schaltet ein
  158.         Element weiter, Mausklick auf Text ruft ein Popupmenü auf.
  159.  
  160.  
  161. 5.2 Das Menü Datei
  162.  
  163. 5.2.1 Neu anlegen
  164.       Legt im Arbeitsspeicher eine leere Regeldatei an.
  165.       Falls Änderungen noch nicht gespeichert worden sind, wird noch einmal
  166.       nachgefragt.
  167.  
  168. 5.2.2 Öffnen ...
  169.       Es folgt eine Dateiauswahlbox, in der Sie auswählen können, aus welcher
  170.       Datei Regeln und Einstellungen geladen werden sollen.
  171.       Bei Programmstart wird automatisch CATSIEVE.INF geladen, falls diese
  172.       Datei vorhanden ist.
  173.  
  174.  
  175. 5.2.3 Information
  176.       Informationen über die Regeldatei werden in einer Dialogbox angezeigt.
  177.  
  178. 5.2.4 Schließen
  179.       Das Fenster wird geschlossen. Da dabei auch die Informationen im
  180.       Arbeitsspeicher verloren gehen, wird sicherheitshalber noch einmal
  181.       nachgefragt.
  182.  
  183. 5.2.5 sichern
  184.       Speichert die aktuelle Konfiguration unter ihrem alten Namen wieder ab.
  185.  
  186. 5.2.6 sichern als ...
  187.       Es folgt eine Dateiauswahlbox, in der Sie auswählen können, in welcher
  188.       Datei die gesammelten Regeln und Einstellungen gespeichert werden
  189.       sollen. Zu empfehlen ist die Datei CATSIEVE.INF, da diese von Catsieve
  190.       am Programmstart eingelesen wird, falls sie gefunden werden kann.
  191.       In den Infodateien (*.inf) werden übrigens gesichert:
  192.       - alle Regeln
  193.       - Packerpfade und Kommandos,
  194.       - alle Schalter
  195.  
  196. 5.2.7 letzte Fassung
  197.       restauriert die Regeln, wie nach dem letzten Speichern oder laden
  198.       vorlagen.
  199.  
  200. 5.2.8 Programm aufrufen
  201.       Es folgt eine Dialogbox, in der sie auswählen können:
  202.       - Pfad zum auszuführenden Programm [oberes editierbares Feld]. Klicken
  203.         Sie die links danebenstehende Box an, so wird eine Fileselectbox
  204.         aufgerufen.
  205.       - Kommandozeile [unteres editierbares Feld]. Klicken sie auf die kleien
  206.         Box daneben, erscheint eine Fileselectbox.
  207.       - Soll in das Verzeichnis des Programmes gewechselt werden? (Besonders
  208.         beim GEM-Programmen zu empfehlen).
  209.       - Soll der Bildschirm gerettet werden? [Bildschirm retten]
  210.       - Ist dies ein Tosprogramm? [Tos-Programm]
  211.         Wenn diese Option gewählt ist, verzichtet Catsieve auf appl_exit und
  212.         so weiter, und verwendet außerdem ARGV.
  213.         Da aber erstaunlich wenige TTP-Programme wirklich mit ARGV
  214.         klarkommen, werden die Parameter auch im normalen
  215.         Kommandozeilenformat übergeben. (So macht Gemini 1.21 das auch)
  216.         btw: Es gibt Programme, die voraussetzen, daß der Wert der
  217.         Environmentvariable "ARGV" leer ist :-(
  218.       Mit Abbruch verlassen sie die Dialogbox, ohne ein Programm zu starten.
  219.       'OK' hingegen startet das Programm.
  220.       Diese Einstellungen werden durch 'Info sichern' nicht gespeichert,
  221.  
  222. 5.2.9 Shell aufrufen
  223.  
  224.       Es folgt eine Dialogbox, in der Sie die Kommandozeile, die die
  225.       hoffentlich installierte Shell ausführen soll, eingeben können.
  226.       Ist keine Shell (vorzugsweise natürlich Gemini/Mupfel oder Okami) im
  227.       Speicher, so wird auch kein Shellkommando ausgeführt. Für Experten: Es
  228.       wird überprüft, ob _shell_p mit dem XBRA-Verfahren verbogen wurde.
  229.       Auch diese Einstellungen werden durch 'Info sichern' nicht gespeichert.
  230.  
  231. 5.2.10 Ende
  232.  
  233.       Catsieve wird verlassen. Im Zweifelsfall (wenn irgendwelche Informationen
  234.       nicht gesichert sein), wird nachgefragt.
  235.  
  236.  
  237. 5.3 Das Menü 'Bearbeiten'
  238.     Hier werden einzelne Regeln bearbeitet.
  239.  
  240. 5.3.1 editieren
  241.       Dieser Menüpunkt ist nur anwählbar, wenn eine Regel in Fenster
  242.       selektiert wurde. Es folgt die komplizierteste Dialogbox des Programms,
  243.       in der die Regel nun bearbeitet werden kann.
  244.       - In der großen Box (links) können der Name der Regel und die Suchwörter
  245.         editiert werden.
  246.       - mit 'OK' werden die Änderungen übernommen.
  247.       - mit 'Abbruch' werden die Änderungen verworfen.
  248.       - 'suchen in': beliebig viele Einträge können angewählt werden. Sind
  249.         Absender und Betreff angewählt, so vergleicht Catsieve beim Filtern,
  250.         ob das Suchwort im Betreff oder Absender einer Mail vorkommt.
  251.         Suchen in Text ist ganz besonders langsam: Es wird im Text der Mails
  252.         gesucht. Zeitaufwendig! Trennungen werden nicht beachtet.
  253.       - 'Vergleich': Wie soll verglichen werden? (Circlebutton)
  254.       - 'Gruppe': "Keine","Einige","Alle" (Circlebutton)
  255.         -- 'wählen' verzweigt in einen Dialog, in dem die Gruppen ausgewählt
  256.            werden sollen, in denen gesucht werden soll, wenn das Flag 'einige
  257.            Gruppen' gesetzt ist. Die Auswahl der Gruppen bleibt übrigens
  258.            erhalten, wenn auf 'alle' oder 'keine' Gruppen geschaltet wird.
  259.         -- 'Auch PM': So kann man auch das Postfach behandeln :-)
  260.       - Modus: Löschen: Ein Circlebutton, durch den eingestellt werden kann,
  261.         ob und wie die betroffenen Mails gelöscht werden sollen. Genaueres
  262.         finden Sie unter Punkt 4.
  263.       - Modus: Kopieren: Mit dem Circlebutton kann eingestellt werden, ob und
  264.         wie die Mails kopiert werden sollen. Genaueres siehe unter Punkt 4.
  265.         Im editierbaren Feld darunter kann dir Datei angegeben werden, in die
  266.         die Mail kopiert werden soll. Hier gibt es einige besondere Dateinamen:
  267.         -- $GRUPPE: Es wird versucht, aus dem Gruppennamen einen Dateinamen zu
  268.            machen. Illegale Zeichen werden gestrichen, der Name passend
  269.            gekürzt. Relevant für die Extension ist der letzte Punkt(.)!
  270.         -- $ABSENDER: dito
  271.         -- $REGEL: hier wird der Regelname benutzt.
  272.         -- $EMPFÄNGER: dito.
  273.         -- $BETREFF: dito.
  274.         Existiert die Datei, so werden sie Mails angehängt, sonst wird die
  275.         Datei angelegt. Ist dies nicht möglich (z.b. weil der Dateiname absolut
  276.         illegal ist), wird die Mail einfach nicht kopiert!
  277.       Der hellgeschriebene Text gibt an, wie oft diese Regel schon
  278.       'zugeschlagen' hat.
  279.  
  280.  
  281.       Dialogbox: Gruppe auswählen
  282.       Hier können die Gruppen ausgewählt werden, in denen gesucht wird, wenn
  283.       auf 'einige Gruppen' geschaltet wird.
  284.  
  285. 5.3.2 informieren
  286.       Präsentiert einige Informationen über die gewählte Regel.
  287.  
  288. 5.3.3 löschen
  289.       Löscht die gewählte Regel nach Rückfrage.
  290.  
  291. 5.3.4 neu
  292.       Legt eine neue Regel an (Höchstgrenze: 50 Regeln pro Datei).
  293.  
  294. 5.4 Das Menü 'Outfile'
  295.     Hier können die Pfade zum Outfile eingestellt werden, außerdem wird hier
  296.     der Filterprozess gestartet.
  297.  
  298. 5.4.1 Filtern
  299.       startet den Filter.
  300.       Zuerst wird (falls nötig) der Packer aufgerufen, um das Outfile zu
  301.       entpacken, oder aber eine Arbeitskopie des ungepackten Outfiles
  302.       angelegt. Während der Packer läuft, können sie diesen mit einiger
  303.       Wahrscheinlichkeit durch CONTROL-C abbrechen. Catsieve nimmt dies nicht
  304.       übel, sondern bricht das Filtern einfach ab.
  305.  
  306.       Wenn die Datei, in der die gefilterten (im Sinne von: zu löschenden)
  307.       Mails aufbewahrt werden sollen, angegeben ist und schon existiert,
  308.       fragt Catsieve nach, ob diese Datei überschrieben werden soll oder die
  309.       neuen Mails (Opfer der Filterroutine) daran angehängt werden sollen.
  310.  
  311.       Danach startet der Filter, und es erscheint eine Informationsbox, der
  312.       sie unter anderem entnehmen können:
  313.       - Message-ID der gerade bearbeiteten Mail
  314.       - Gruppe der gerade bearbeiteten Mail
  315.       - laufende Nummer.
  316.       - Anzahl gefilterter Nachrichten
  317.       - letzte gefilterte Nachricht mitsamt auslösender Regel.
  318.  
  319.       Ist das Outfile komplett bearbeitet, so wird wieder, falls gewünscht,
  320.       der Packer angeworfen.
  321.  
  322. 5.4.2 'Outfile suchen'
  323.       Es erscheint eine Dateiauswahlbox, in der das Outfile gesucht werden
  324.       kann. (Das ist absolut notwendig! Woher soll Catsieve sonst wissen, was
  325.       es filtern soll?)
  326.  
  327. 5.4.3 'Eingangsoutfile suchen' und 'Ausgangsoutfile suchen'
  328.       Für den Fall, daß eingehende und ausgehende Datei nicht identisch sind,
  329.       können die Pfade auch getrennt ausgewählt werden.
  330.       (Dies ist z.B. sinnvoll, wenn Catsieve das Outfile nicht wieder
  331.       einpacken soll).
  332.       ACHTUNG: Catsieve erkennt nicht an den Endungen, welcher Packer benutzt
  333.       werden soll! Das muß der Benutzer einstellen!
  334.  
  335.  
  336. 5.5 Das Menü 'Pfade'
  337.  
  338.  
  339. 5.5.1 'Sicherungspfade'
  340.       Hier kann eingegeben werden:
  341.       - Pfad für das Backup des eingehenden Outfiles. Wird keiner angegeben,
  342.         so wird auch kein Backup angelegt.
  343.         (Die Option ist für den Anwender wohl eher überflüssig, erleichtert
  344.         aber dem Autor das Leben sehr ....)
  345.       - Pfad zur Datei, in der die ausgefilterten Mails aufbewahrt werden.
  346.  
  347. 5.5.2 'Packer wählen'
  348.       Es erscheint eine Dialogbox, in der man die Packer auswählen kann. Es
  349.       können unterschiedliche Packer für die eingehende und die ausgehende
  350.       Datei verwendet werden. Die obere Hälfte der Box dient der Einstellung
  351.       des Packers für das eingehende File, die untere ...
  352.       Beide Teile der Box werden sehr ähnlich bedient:
  353.       - Pfad zum Packer [oberes editierbares Feld]: Der Pfad zum Packer. Mit
  354.         einem Klick auf die Box links daneben wird eine Dateiauswahlbox
  355.         aufgerufen.
  356.       - Kommandozeile des Packers. Sollte auf jeden Fall stimmen ....
  357.         Mit einem Klick auf die kleine Box zur Linken veranlaßt man
  358.         Catsieve, eine Standardeinstellung einzutragen, falls für den Packer
  359.         eine bekannt ist (Derzeit: LHarc, Zoo, ARC). btw: Da die alten
  360.         Versionen der Lharc (1.13xx) keinen Switch kennen, mit denen die
  361.         Ausgaben unterbunden werden können, wird auch keine vorgeschlagen.
  362.         btw2: Da zumindest Lharc V1.13xx standhaft über das Bios ausgibt,
  363.         kann auch keine Ausgabeumleitung erfolgen. Deshalb ist auch noch
  364.         keine implementiert.
  365.       - 'Bild retten': Veranlaßt Catsieve dazu, den Bildschirm vor Aufruf
  366.         des Packers zu retten. Das ist meine Antwort auf das Problem mit der
  367.         Ausgabeumleitung bei Lharc. Nicht schön, aber es funktioniert.
  368.         (Außerdem kann man erkennen, wie weit der Packer ist ...)
  369.       Ist kein Dateiname angegeben, so wird dies als 'nicht packen' bzw. als
  370.       'ungepackt' interpretiert.
  371.  
  372. 5.6 Das Menü Optionen
  373.  
  374. 5.6.1 Trennzeichen eingeben
  375.       Es folgt eine Dialogbox, in der eingestellt werden kann, welche Zeichen
  376.       Catsieve benutzt, um bei 'wortgenauem Vergleichen' die Wörter
  377.       auseinanderzuhalten.
  378.  
  379. 5.6.2 Diverses
  380.       - Quark-Maus-Namen und Quark-M-Namen
  381.         Einige Quarkboxen benennen die Mausgruppen in MAUS-xxx oder M-xxx um.
  382.         Mit der entsprechenden Option können die Namen gewandelt werden: Das
  383.         'MAUS-' bzw 'M-' vor den Gruppennamen wird gelöscht.
  384.         Ich rate davon ab, diese Optionen zu benutzen! Gruppennamen verlieren
  385.         dadurch ihre Eindeutigkeit! Mails, die man mit diesen gewandelten
  386.         Gruppennamen über die Quarkbox verschickt, könnten falsch einsortiert
  387.         werden!
  388.         Es gibt für die Verwendung dieser Optionen nur einen Grund: Jemand
  389.         MausTauscht sonst an einer Maus und muß (aus welchem Grund auch immer)
  390.         an einer Quark tauschen. Dann kann mit Hilfe dieser Funktionen der
  391.         Gruppenname konvertiert werden, so daß die Kommentarverkettung erhalten
  392.         bleibt und das MausTauschprogramm keine neuen Gruppen dieses Namens
  393.         anlegt!
  394.         Außerdem sollten die Gruppennamen im in die Quark eingehenden Infile
  395.         besser von Hand (Texteditor) gewandelt werden oder gleich ein
  396.         Quarkgruppenname (CAT: F9 + Handeingabe) eingegeben werden!
  397.         Also: Wer diese Funktionen nicht benötigt: Finger davon!
  398.       - Statusboxen zeigen
  399.         Wird dies ausgeschaltet, so zeigt Catsieve keine Statusboxen mehr. Das
  400.         mag unter Multitasking sinnvoll sein.
  401.  
  402. 6 Die Bedienung des Fensters
  403.   Im Fenster werden die Regelnamen angezeigt. Mit einem Einfachklick wird eine
  404.   Regel selektiert, ein Doppelklick führt in die Editierbox (wie unter
  405.   'Bearbeiten - editieren').
  406.   Die Elemente im linken Fensterrand haben besondere Funktionen:
  407.  
  408. 6.1 das beschriebene Blatt
  409.     Die gewählte Regel wird editiert (wie unter 'Bearbeiten - editieren')
  410.  
  411. 6.2 das große I
  412.     Bietet wie 'Bearbeiten - informieren' eine Kurzinfo über die gewählte
  413.     Regel.
  414.  
  415. 6.3 das Feuer
  416.     Die Regel wird nach Rückfrage gelöscht.
  417.  
  418. 6.4 das leere Blatt
  419.     legt wie 'Bearbeiten - neu' eine neue Regel an.
  420.  
  421. 6.5 das +
  422.     Schaltet eine Regel wieder ein, wenn sie mit dem '-'-Symbol ausgeschaltet
  423.     wurde.
  424.  
  425. 6.6 das -
  426.     Mit diesem Symbol kann eine Regel ausgeschaltet werden. Die eingestellten
  427.     Parameter bleiben unverändert, doch die Regel wird beim Filtern nicht
  428.     berücksichtig.
  429.  
  430. 7 Einstieg - Die ersten Schritte
  431.   - kopieren Sie Catsieve.Prg, Catsieve.Rsc, Catsieve.Inf und Beispiel.Inf in
  432.     einen Ordner ihrer Wahl.
  433.   - Starten sie Catsieve.
  434.   - Pfad zur Outfile Datei auswählen,
  435.   - Pfad zum Packer einstellen.
  436.   - Vorsichtshalber 'Backup anlegen' ('Sicherungspfade') wählen. Man weiß ja
  437.     nie...
  438.   - Dabei (im Dialog Sicherungspfade) gleich eine Datei bestimmen, in der die
  439.     ausgefilterten Mails abgelegt werden sollen.
  440.   - Alle schon vorhandenen Regeln löschen oder ausschalten.
  441.   - Neue Regeln anlegen.
  442.   - 'sichern'
  443.   - Filter starten.
  444.  
  445.  
  446. 8 Weitere Features
  447. 8.1 Die Kommandozeile
  448.     Catsieve kann auch mit Parametern (z.B. aus Kommandointerpretern) gestartet
  449.     werden. Implementierte Kommandos:
  450.     -i, -I : danach muß die Infodatei folgen, die Catsieve anstelle von
  451.              Catsieve.Inf beim Start laden soll.
  452.     -a, -A : Catsieve soll automatisch arbeiten. Es passiert folgendes: Das
  453.              Programm lädt Catsieve.Inf oder die mittels '-i' angegebene Datei,
  454.              filtert das Outfile und verabschiedet sich wieder.
  455.              Bei etwaigen auftretenden Fehlern bricht Catsieve das Filtern
  456.              sofort ab und verabschiedet sich mit Fehlercode.
  457.     ACHTUNG: Catsieve benutzt grundsätzliche einige AES-Funktionen! Anders geht
  458.     es mit GFABASIC nicht! Catsieve darf also nicht in .TOS oder .TTP umbenannt
  459.     werden, auch wenn es automatisch laufen soll.
  460.  
  461.  
  462. 9 Bekannte Fehler und Einschränkungen
  463.   - Die Flys (fliegende Dialoge) sind noch im Betatest. Daher können
  464.     eventuell einige unschöne Dinge passieren. Andererseits scheint alles
  465.     recht gut zu laufen.
  466.   - Keine Wildcards. Mag sein, daß ich die noch einbaue.
  467.   - 50 Gruppennamen können verwaltet werden.
  468.   - Es ist nicht (im Gegensatz zu anderen Laberfiltern) möglich, eine Gruppe
  469.     bis auf einige Mails auszufiltern. 'Gruppe filtern bis auf Mails von xxx
  470.     @ xx' oder 'Gruppe filtern bis auf Mails mit Betreff yyyyy'. Es wäre zwar
  471.     sehr leicht zu implementieren, doch verstehe ich den Sinn solcher
  472.     Optionen nicht.
  473.  
  474.  
  475. 10 mögliche zukünftige Erweiterungen
  476.   - Wildcards (wenn mir jemand eine passende Routine für Bugsic zur Verfügung
  477.     stellt).
  478.   - Clipboardunterstützung.
  479.  
  480. 11 Warnungen
  481.   - Catsieve ist in GFABASIC programmiert. Aber selbst die jüngste Version
  482.     3.6 läuft, zumindest auf dem TT, nicht einwandfrei! (mal abgesehen davon,
  483.     daß _X, _Y, _C im compiliertem Programm ganz einfach 0 ergeben).
  484.     Ich habe mein möglichstes getan (insbesondere das Programm sehr sauber
  485.     geschrieben), doch habe ich nun einmal keinen Atari TT, auf dem ich
  486.     Catsieve ausprobieren könnte. (Übrigens ist Catsieve mein letztes
  487.     größeres Projekt in Bugsic, sieht man mal von den Flys ab. Zwar schreit
  488.     auch ein älteres Programm geradezu nach Weiterentwicklung, aber da werde
  489.     ich wohl auf Modula umsteigen.)
  490.  
  491.   - Catsieve (wie alle Laberfilter) widerspricht dem Sinn des MausTausches
  492.     völlig. Informationen werden weggeworfen!
  493.     Der Einsatz des Laberfilters will gut überlegt sein!
  494.  
  495.   - Ich, Uwe Ohse, übernehme keine Haftung für Schäden egal welcher Art,
  496.     die durch die Benutzung dieses Programmes, unabhängig davon, ob sie
  497.     korrekt erfolgte oder nicht, direkt oder indirekt entstehen.
  498.     Dies schließt Schäden materieller und finanzieller Art ausdrücklich ein,
  499.     ist aber nicht darauf beschränkt.
  500.  
  501.  
  502. 12 einige persönliche Anmerkungen
  503.   - Für mich persönlich ist die wichtige Funktion 'Mail kopieren'. Damit kann
  504.     man unter anderem für Bekannte Mails bequem kopieren.  Die Löschfunktionen
  505.     lohnen sich für mich schon länger nicht mehr.
  506.     (Es sei denn, es kommt mal wieder eine dummdämliche Diskussion wie die
  507.     über Oxyd2/Spacola [Atari ST] oder Soziologen [Maus] auf)
  508.   - wer einen Absender in allen Gruppen und in den PM's filtert, hat
  509.     keine Gelegenheit mehr, eventuelle Entschuldigungen zu lesen.
  510.   - wer ungewollt wichtiges filtert, ist selber schuld.
  511.   - wer einen Betreff in 'allen Gruppen' und 'ungenau' filtert ist ebenfalls
  512.     selbst schuld.
  513.   - wer öffentlich bekanntgibt, daß er eine Person gezielt filtert, gibt
  514.     damit automatisch das Recht auf Nutzung von Catsieve auf.
  515.   Von Flames wegen Entwicklung oder Benutzung eines Laberfilters bitte ich
  516.   deshalb Abstand zu nehmen. (Ja, der Hinweis *ist* wichtig, da solch
  517.   unerfreuliche Mails schon gekommen sind.)
  518.  
  519. 13 Tips und Tricks
  520.  - der beste Laberfilter ist das eigene Hirn in Verbindung mit der
  521.    Spacetaste.
  522.  - Catsieve läuft deutlich schneller, wenn weniger Regeln und Suchworte
  523.    verwendet werden.
  524.  - Die Funktion 'im Text suchen' ist unglaublich langsam! Meiden!
  525.  
  526.  
  527. 14 Die Sicherungsdatei für gefilterte Nachrichten
  528.    Ergänzt man diese Datei, indem man als letzte Zeile einfach ein '#'
  529.    (Doppelkreuz) einträgt, benennt sie in Outfile.txt um und packt sie (falls
  530.    nötig), so kann man Cat die ausgefilterten Nachrichten als Outfile
  531.    unterjubeln. Die fällige Fehlermeldung: 'Logfile-Fehler' (oder so ähnlich)
  532.    ignoriert man (aber den Ordner Messages nicht löschen lassen).
  533.  
  534.  
  535. 15 Was ist, wenn Fehler auftreten?
  536.  - Catsieve filtert zuwenig?
  537.      Was solls? Aber im Ernst: Während der Entwicklung von Catsieve habe ich
  538.      das häufig geglaubt. In allen Fällen lag es an falscher Formulierung der
  539.      Regeln.
  540.  
  541.  - Catsieve filtert zuviel?
  542.      Das ist schon ernster. Aber auch hier dürfte der Grund in falscher
  543.      Formulierung der Regeln zu suchen sein.
  544.      erste Hilfe: Siehe unter 14
  545.      dann sieht man sich das alles an, und korrigiert die Regeln
  546.      entsprechend.
  547.      (Sollte der Fehler nicht an den Regeln liegen: Mail an mich).
  548.  
  549.  - Catsieve stürzt ab?
  550.      PM an mich (wenn möglich mit Sysmonprotokoll des Absturzes).
  551.  
  552.  
  553. 16 abschließende Worte
  554.  
  555. Fehlermeldungen und Erweiterungsvorschlägen gegenüber bin ich aufgeschlossen.
  556. Da Catsieve nicht mein einziges Hobby ist und es außerdem (für mich) seinen
  557. Zweck erfüllt: Fehler korrigiere ich schnell (wenn ich sie nachvollziehen
  558. kann), Erweiterungen brauchen länger.
  559.  
  560. Sollte Ihnen das Programm gefallen, bin ich kleineren Spenden nicht
  561. abgeneigt. Meine Bankverbindung ist:
  562.  
  563.          Kontonummer 34211292
  564.          Sparkasse Paderborn (BLZ 472 501 01)
  565.  
  566.  
  567. Viel Spaß, und filtert möglichst wenig,
  568.  
  569. Uwe Ohse
  570.  
  571.  
  572.  
  573. P.S.: Das Programm ist ziemlich dick geworden. Naja, was solls.
  574. P^2.S.: Ja, das liegt auch daran, daß ich unbedingt einige Features der Flys
  575.         demonstrieren mußte.
  576.  
  577.